Запуск Tarantool DB с помощью TT CLI¶

Пререквизиты¶

Для выполнения примера требуются:

• архив для развёртывания Tarantool DB. Архив можно скачать в личном кабинете tarantool.io, в разделе tarantooldb/release/for_deploy/;

• утилита TT CLI;

• исходные файлы примера up_with_tt.

  Примечание

  Есть два способа получить исходные файлы примера:

  • Архив с полной документацией Tarantool DB, полученный по почте или скачанный в личном кабинете tarantool.io. Пример архива: tarantooldb-documentation-1.0.0.tar.gz. Пример up_with_tt расположен в таком архиве в директории ./doc/examples/up_with_tt/.

  • Отдельный архив up_with_tt.tar.gz, скачанный c сайта Tarantool.

Используемые файлы¶

В примере up_with_tt для конфигурации кластера используются файлы из директории ./tarantooldb/:

• tt.yaml – конфигурация TT CLI. Чтобы сгенерировать этот файл, используется команда tt init;

• instances.yml – список узлов кластера для запуска в текущем окружении;

• replicasets.yml – описание наборов реплик и их ролей.

Запуск стенда¶

Перейдите в директорию с примером up_with_tt:

cd ./doc/examples/up_with_tt/

Загрузите в эту директорию архив для развёртывания Tarantool DB и распакуйте его:

tar -xzvf tarantooldb-<VERSION>.<OS>.<ARCH>.tar.gz

Здесь:

• VERSION – версия продукта;

• OS – поддерживаемая операционная система;

• ARCH – архитектура процессора.

Пример: tarantooldb-1.0.0.linux.x86_64.tar.gz.

При распаковке будет создана директория tarantooldb. Переименовывать её нельзя. Скопируйте в эту директорию файлы instances.yml, replicasets.yml и tt.yml из директории up_with_tt:

cp *.yml tarantooldb/

После копирования перейдите в директорию tarantooldb:

cd tarantooldb

Запустите экземпляры Tarantool DB с помощью команды tt start:

tt start tarantooldb

Проверить состояние узлов можно, используя команду tt status:

tt status tarantooldb

Ответ выглядит так:

INSTANCE                      STATUS      PID
tarantooldb:router-msk        RUNNING     118242
tarantooldb:router-spb        RUNNING     118243
tarantooldb:storage-1-msk     RUNNING     118244
tarantooldb:storage-1-spb     RUNNING     118245
tarantooldb:storage-2-msk     RUNNING     118246
tarantooldb:storage-2-spb     RUNNING     118247
tarantooldb:stateboard        RUNNING     118249

Соберите кластер из узлов Tarantool DB:

tt cartridge replicasets setup --bootstrap-vshard --name tarantooldb

Теперь кластер доступен по адресу одного из узлов (кроме stateboard), например http://localhost:8081.

Остановка кластера¶

Остановить кластер можно с помощью команды tt stop:

tt stop tarantooldb